package com.zenithmind.task.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.zenithmind.common.result.PageResult;
import com.zenithmind.task.pojo.entity.TaskComment;
import com.zenithmind.task.pojo.query.TaskCommentQuery;
import com.zenithmind.task.pojo.vo.TaskCommentVO;

import java.util.List;

/**
 * 任务评论服务接口
 * 
 * @author ZenithMind Team
 * @since 2025-01-09
 */
public interface TaskCommentService extends IService<TaskComment> {

    /**
     * 分页查询评论列表
     *
     * @param query 评论查询条件
     * @param userId 当前用户ID
     * @return 评论分页列表
     */
    PageResult<TaskCommentVO> getCommentPage(TaskCommentQuery query, String userId);

    /**
     * 查询评论树（包含回复）
     * 
     * @param taskId 任务ID
     * @param userId 当前用户ID
     * @return 评论树
     */
    List<TaskCommentVO> getCommentTree(String taskId, String userId);

    /**
     * 根据ID查询评论详情
     * 
     * @param id 评论ID
     * @param userId 当前用户ID
     * @return 评论详情
     */
    TaskCommentVO getCommentById(String id, String userId);

    /**
     * 添加评论
     * 
     * @param comment 评论信息
     * @param userId 评论者ID
     * @return 添加结果
     */
    Boolean addComment(TaskComment comment, String userId);

    /**
     * 回复评论
     * 
     * @param parentId 父评论ID
     * @param content 回复内容
     * @param replyToId 被回复人ID
     * @param userId 回复者ID
     * @return 回复结果
     */
    Boolean replyComment(String parentId, String content, String replyToId, String userId);

    /**
     * 更新评论
     * 
     * @param comment 评论信息
     * @param userId 操作者ID
     * @return 更新结果
     */
    Boolean updateComment(TaskComment comment, String userId);

    /**
     * 删除评论
     * 
     * @param id 评论ID
     * @param userId 操作者ID
     * @return 删除结果
     */
    Boolean deleteComment(String id, String userId);

    /**
     * 点赞评论
     * 
     * @param id 评论ID
     * @param userId 用户ID
     * @return 点赞结果
     */
    Boolean likeComment(String id, String userId);

    /**
     * 取消点赞评论
     * 
     * @param id 评论ID
     * @param userId 用户ID
     * @return 取消结果
     */
    Boolean unlikeComment(String id, String userId);

    /**
     * 置顶评论
     * 
     * @param id 评论ID
     * @param userId 操作者ID
     * @return 置顶结果
     */
    Boolean pinComment(String id, String userId);

    /**
     * 取消置顶评论
     * 
     * @param id 评论ID
     * @param userId 操作者ID
     * @return 取消结果
     */
    Boolean unpinComment(String id, String userId);

    /**
     * 查询任务的最新评论
     * 
     * @param taskId 任务ID
     * @param limit 数量限制
     * @param userId 当前用户ID
     * @return 最新评论列表
     */
    List<TaskCommentVO> getLatestComments(String taskId, Integer limit, String userId);

    /**
     * 查询用户的评论
     * 
     * @param userId 用户ID
     * @param pageNum 页码
     * @param pageSize 页大小
     * @return 用户评论列表
     */
    PageResult<TaskCommentVO> getUserComments(String userId, Integer pageNum, Integer pageSize);

    /**
     * 添加系统日志评论
     * 
     * @param taskId 任务ID
     * @param content 日志内容
     * @param operatorId 操作者ID
     * @return 添加结果
     */
    Boolean addSystemLog(String taskId, String content, String operatorId);
}
